Book 2 Quick Reference 




Personal Computer 
Productivity Series 



SCRIPT/PC 

Book 2 Quick Reference 

Program by: Robert N. Seidel 

Charles W. Gainey Jr. 



First Edition (January, 1984) 

The following paragraph does not apply to the United Kingdom or 
any country where such provisions are contrary to local law: 

International Business Machines Corporation provides this 
manual "as is", without warranty of any kind, either expressed or 
implied, including, but not limited to, the implied warranties of 
merchantability and fitness for a particular purpose. IBM may 
make improvements and/ or changes in the product(s) and/or the 
program(s) described in this manual at any time and without 
notice. 

This publication contains examples of data markup and text. All 
names of individuals, companies, brands, and products used in 
these examples are fictitious, and any similarity to the names, 
addresses or products used by an actual business is entirely 
coincidental. 

This product could include technical inaccuracies or typographical 
errors. Changes are periodically made to the information herein; 
these changes will be incorporated in new editions of this 
publication. 

Products are not stocked at the address below. Requests for 
copies of this product and for technical information about the 
system should be made to your authorized IBM Personal 
Computer dealer. 

A Reader's Comment Form is provided at the back of this 
publication. If the form has been removed, address comments to: 
IBM Corp; Personal Computer, P.O. Box 1328-C, Boca Raton, 
Florida 33432. IBM may use or distribute any of the information 
you supply in any way it believes appropriate without incurring 
any obligations whatever. 



©Copyright IBM Corporation 1978, 1983, All Rights Reserved 



About This Book 



How to Use This Book 

This book is the Quick Reference to SCRIPT/PC 
Control Words and the Generalized Markup Language 
(GML) Starter Set of tags. 

The information in this book is organized as follows: 

• The first part gives you a quick reference to each 
SCRIPT/PC control word and its options. 

• The second part gives you an equivalent explanation 
of every tag supported by SCRIPT/PC's Starter Set 
of GML tags. 
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Control Words 



The following list contains the SCRIPT/PC control 
words in alphabetical order, including all options and a 
short description. Control words used only in macro 
definitions are identified by the term macro: 



Word 


Options 


Description 




label [line] 


Set label for .GO *macro 


.AN 


comparand 1 test 
comparand2 [target] 


Conditional AND 


.AP 


[d:]filename[.ext] 


Append (add) next input 
file 


.BF 


[font-id] 


Begin new font 


.BM 


V 


Specify bottom margin 


DD 

. o K 




Force break in formatting 


.BX 


dl ... dn 
OFF 

CHAR {GRAPHICS} 
{MATRIX} 


Draw a box that can 

i n r* 1 1 iH tpYt 

1111/ 1 UlJC LCA L 


.CD 


2 pi p2 


Define two-column format 


.CE 


{ON} 

{OFF} 

{line} 


Center text on line 


.CL 


{h} 


Specify column width for 
two-column format 


.CM 


[comments] 


Comment 


* 


[comments] 


Comment 
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Word 


Options 


Description 


.CP 


[v] 


Conditional page eject 


.CS 


n {ON} 
{OFF} 
{INCLUDE} 
{IGNORE} 


Include or ignore text 


,CT 


[text] 


Continue text without 
break 


.DC 


{PS c} 
{PS OFF} 
{CW c} 
{RB c} 
(GML Cj 


Change special characters 
to other characters, or 
define control characters 


.DD 


file-id 


Name data file-id 


.DF 


font-id [US] 
[UP] 
[UC] 

[FONT definition^]] 


Define new font 


.DM 


name [OFF] 


Begin macro definition or 
erase a macro 


.Do 




Double space mode 


xr 


[CLOSE] 


r orce End-oi-iile 


.EL 


[target] 


Conditional ELSE 


.FO 


{ON} 

{OFF} 

{LEFT} 


Specify formatting options 


.FN 


{ON} 
jOrr j 


Mark text for footnote 


GO 


IClUtl 


VJULU IdUvI llictvl \J 


.GS 




GML Services *macro 
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Provided via the HEADDEF.SCT macro library: 



Word 


Options 




.HO 




Heading (Table of 
Contents) 


II 1 
. 11 1 




Heading 1 (Chapter) 


.H2 




Heading 2 


.H3 




Heading 3 


.H4 




Heading 4 


.H5 




Heading 5 (Imbedded in 
text) 


.H6 




Heading 6 (Imbedded in 
text) 




Word 


Options 


Description 


.IF 


comparand 1 test 
comparand2 [target] 


Conditional IF 


.IL 


[h] 


Indent only one line 


.IM 


[d :]f ilename[. ext] 


Imbed new input file 


.IN 


[h] [NOBREAK] 


Indent 


.IR 


[h] [NOBREAK] 


Indent from right margin 


.IX 




Start index here 


.LL 


[h] 


Specify line length 


.MC 




Enter multicolumn mode 
(two-column) 


.ME 




Macro exit *macro 


.OF 


[h] 


Offset after one line 


.OR 


comparand 1 test 
comparand2 [target] 


Conditional OR 


.PA 


[n] 


Skip to top of next page 


.PF 




Select previously used font 
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Word 


Options 


Description 


.PI 


{REF /text[/ref/]j 
{START /text] 
{END} 
{text} 


Put text into index 


T»T 

.PL 


V 


Specify page length 


.PM 


[h] 


Specify page margins 


.PN 


{n} 

{ON) 
{OFF} 


Specify page number 


.PT 


{line } 
{ line} 


Put to table of contents 
file 


•QQ 




Quick quit 


.QU 




Quit 


.RC 


{n c} 
{ON} 
{OFF} 

{ADJUST h} 


Revision code at left 
margin 


.RH 


{ON} 

{OFF} 

{CANCEL} 

{SUP} 

{RES} 


Running header definition 


.RI 


{ON} 

{OFF} 

{line} 


Right adjust lines 


.RT 


{TOP } n /partl/part2/ 

part3 / 

{BOTTOM} 


Specify running title 


.RV 


symname = ['] 


Read variable from 
keyboard 


.SC 




Enter single column mode 
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Word 


Options 


Description 


.SE 


symname {= 'string'} 

{= &1 
{= value} 
{= SUBSTR 
string start 
length} 
{= INDEX 
string 1 
string2} 
{OFF} 


Set symbols 


.SK 


[v] 


Skip lines 


SP 


L V J 


Snare lines 


.SS 




Single space mode 


.su 


{ON} 
(OFF) 


Substitute symbol 


sx 


{¥} /l part/ fill/ rpart/ 
{C} 


Split text 


.TB 


hh ... 


Set tab stops 


.TC 


[n] [name] 

V r* r\T\t r r\\\ 

[/] 


Place table of contents 


.TE 




Terminal entry mode 


.TH 


[target] 


Conditional THEN 


.TI 


[s t] ... 


Translate input 


TM 

. 1 1V1 


L V J 




.TR 


[s t] ... 


Output character translate 


.TY 


text [=] 


Type text on display 
screen 
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Word 


Options 


Description 


.UC 


{ON} 

{OFF} 

{line} 


Underscore and capitalize 


.UD 


{ON} 


Underscore definition 


.UN 


[h] 


Undent (indent left) 


.UP 


{ON} 

{OFF} 

{line} 


Uppercase (capitalize) 


.US 


{ON} 

{OFF} 

{line} 


Underscore (underline) 


.zz 


{ON} 
{OFF} 


Diagnostic (Debug) *macro 
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Generalized Markup Language (GML) 
Tags 



The following Starter Set of generalized Markup 
language (GML) tags are arranged in alphabetical 
order. If two or more lines of options are given, the 
order of entry must be left to right, top to bottom: 



Tag 


Options (Attributes) 


Description 


:ABSTRACT 




Insert ABSTRACT 


:ADDRESS 




Start ADDRESS 


.AT TTVTTT 

.ALINE 


[.line of address] 


Insert Address 
LINE 


.APPENDIX 




Start APPENDIX 
of document 


.AUTHOR 


[.author name text] 


Insert AUTHOR 
name(s) 






^stnrt RAPK Matter 

of document 


.BODY 




Start BODY of 
document 


:CIT 


[.cited text] 


Start CITation 


:DATE 


[.optional date text] 


Insert DATE 


:DD 


[.description text] 


Start Definition 
Description 


:DL 


[COMPACT] 
[TSIZE=ss] 
[TERMHI=h] h=(0,2} 


Start Definition 
List 



Tag 


Options (Attributes) 


Description 


:DOCNUM 


[.alphanumeric text] 


Insert DOCument 
NUMber 


:DT 


[.term text] 


Start Definition 
Term 


:EADDRESS 




End ADDRESS 
[:ADDRESS] 


:ECIT 




End CITation 
[:CIT] 


:EDL 




End Definition List 
[:DL] 


:EFN 




End Footnote [:FN] 


:EGDOC 




End Document 
[:GDOC] 


:EHP1 


[.text] 


End underscore 
[:HP1] 


:EHP2 


[.text] 


End bold [:HP2] 


:EHP3 


[.text] 


End bold and 
underscore [:HP3] 


:ELQ 




End Long Quote 
[:LQ] 


:EOL 




End Ordered List 
[:OL] 


:EQ 




End Quote [:Q] 


:ESL 




End Simple List 
[:SL] 


:ETITLEP 




End TITLE Page 
[:TITLEP] 


:EUL 




End Unordered List 
[:UL] 


:EXMP 




End eXaMPle 
[:XMP] 
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Tag 


Options (Attributes) 


Description 


:FN 


ID=reference id 
[.footnote text] 


Start FootNote 


:FNREF 


[REFID=reference-id] 


FootNote 
REFerence 


:FIG 


[PLACE={INLINE}] 
{TOP} 

[ID=id] 

[FRAME= {RULE}] 
{BOX} 
{NONE} 

TDEPTH^ddl 

[WIDTH= {PAGE}] 
{ww} 


Start FIGure 


:FIGCAP 


[.caption text] 


FIGure CAPtion 


.FIGDESC 


[.description text] 


FIGure 
DESCription 


:FIGLIST 




List of illustrations 


:FIGREF 


[REFID = reference-id] 
[PAGE= {YES}] 
{NO} 


FIGure REFerence 


.FRONTM 




Start FRONT 
Matter 


:GDOC 


[SEC='security class'] 
[.bottom title] 


Start General 
Document 


:HP1 


[.text] 


Start underscore 


:HP2 


[.text] 


Start bold 


:HP3 


[.text] 


Start bold and 
underscore 


:HDREF 


[REFID=id] 
[PAGE={YES}] 
{NO} 


Heading Reference 
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Tag 


Options (Attributes) 


Description 


:H0 


[ID=id] [STITLE= 

short title] 
[.title text] 


Heading 


:H1 


[ID=id] [STITLE= 

short title] 
[.title text] 


Heading 1 




H2 


[ID=id][.title text] 


Heading 2 




H3 


l~T "I~~V * A ' A 1 A A~t 

[ID=id][.title text] 


Heading 3 




H4 


[ID=id][.title text] 


Heading 4 




H5 


[ID=id][.title text] 


Heading 5 




H6 


rTT\ * j ~ir i. 

[!D-idJ[.title text] 


Heading 6 




INDEX 




Insert Index 
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[ID=id][PG={START}] 

{END} 
.text of entry 


Create Index entry 


:IREF 


[REFID=refid] 
[PG={START}] 

{END} 
[SELlD=seeidJ 


Refer to Index 
entry 




LI 


[.list text] 


Line Item for list 




LP 


[.list part text] 


Line Part 




LQ 


[.long text] 


Start Long Quote 




NOTE 


[.note text] 


Start NOTE - input 
line 


:OL 


[COMPACT] 


Start Ordered List 


:P 


[.start of paragraph 
text] 


Start Paragraph 


:PC 


[.paragraph text 
continuation] 


Paragraph 
Continuation 


rPREFACE 




Insert PREFACE 
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Tag 


Options (Attributes) 


Description 


:Q 


[.quoted text] 


Start of Quoted 
text 


:SL 


[COMPACT] 


Start Simple List 


:TITLE 


[.actual title text] 


TITLE line of text 


:TITLEP 




Start TITLE Page 


:TOC 




Insert Table Of 
Contents 


:UL 


[COMPACT] 


Start Unordered 
List 


:XMP 


[DEPTH=dd] 


Start eXaMPle - 
copy text 



Printer Font Definitions 

The printer codes supported are for the IBM PC 
Graphics and IBM PC Matrix printers. The printer is 
set up for a particular print font and other options by 
use of the Define font control word (.DF). Print fonts 
and other supported options are shown on the following 
page. 
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Fonts 



Highlight Print 



Font 


Description 


CM 


Compressed 
Characters 


DW 


Double Width 
Characters 


SB 


Subscript Character 
Set 


SP 


Superscript Character 
Set 



Opt. 


Description 


US 


Underscore 


UP 


Uppercase 


uc 


Underscore and 
Capitalize 



Emphasized Print 



Print Lines Per Inch 



Opt. 


Description 


DS 


Double Strike - Bold 


EM 


Emphasized - Very 
Bold 



Opt. 


Description 


L6 


*6 Lines Per Inch 


L8 


8 Lines Per Inch 



Printer Character Sets 



Opt. Description 

CI *Graphics Printer-Char 
Set 1 

C2 Graphics Printer-Char 
Set 2 



Printer Direction 



Opt. 


Description 


BD 


♦Bidirectional 


LR 


Left to Right 
Undirectional 



Notes: 

1 . * = SCRIPT/ PC default options. 

2. If Double Width Characters are used with .FO ON, the 
righthand margin may not be totally even (justified). 

3. Options CI, C2, LR, SB and SP are not available on the 
IBM Matrix Printer. 
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Heading Level Summary 



The following chart is a summary of the GML Heading 
levels. The heading levels are listed across the top and 
the summary directly below each heading level: 



Heading Level 


HO 


HI 


H2 


H3 


H4 


H5 


H6 


New Page 


yes 


yes 












Space Before Heading 








3 


3 


3 


1 


1 


Space After Heading 


5 


3 


2 


2 


2 








Heading Inline 












yes 


yes 


Capitalized 


yes 


yes 


yes 










Underscored 


yes 


yes 


yes 


yes 






yes 


Boldface 


yes 


yes 


yes 


yes 


yes 


yes 




Table of Contents entry 


yes 


yes 


yes 


yes 


yes 






ID Attribute recognized 


yes 


yes 


yes 


yes 


yes 


yes 


yes 


STITLE Attribute 
recognized 


yes 


yes 













SCRIPT/PC Provided Symbols 



The following symbols are provided by SCRIPT/PC. 

& = Page Number 

&* = Passes information to a tag (macro) 

&*0 - &*18 = Passes information (parameters) to 
a tag (macro) 

&*0 = Count of non-null tokens in &* 

&*18 = Tag (macro) text which follows the 
period ( . ) 

&$PASS = Number of passes 

&FIGLST = Count of pages in list of illustrations 

&SYSDATE = Date 

&SYSTIME = Time of day 

&SYSDAYOFM = Day of Month (1 ... 31) 

&SYSH0UR = Hour of the Day (1 ... 24) 

&SYSMINUTE = Minute in the Hour (00 ... 59) 

&SYSSEC0ND = Second in the Minute (00 ... 59) 

&SYSYEAR = Year (19xx) 

&T0C = Count of pages in tabl e-of-contents 

&rbl . = Requi red Bl ank 

&gml . = Colon (: ) 

&amp. = Ampersand (&) 

&semi . = Semicolon ( ; ) 
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used for revisions. 
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regarding the IBM Personal Computer or programs for 
the IBM Personal Computer, or for requests for 
additional publications; this only delays the response. 
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Software Included: 



System requirements: 




IBM 80-column 
display 




128KB of memory 
One diskette drive 
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